home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / gfx / misc / xipaintmodul43.readme < prev   
Text File  |  1996-05-05  |  18KB  |  374 lines
  1. Short:    Univ. loader&anim.saver for XiPaint
  2. Author:   hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  3. Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  4. Type:     gfx/misc
  5. Kurz:     XiPaint-Universal-Lader&Animationssp.Modul
  6.  
  7. HHsFastUniversalXiPaintModule 4.3 (incl. PhotoCD- & TrueColorAnim-support)
  8. =================================
  9.  
  10. new in V4.x: Downscaled loading support: Loading big pictures in downscaled
  11.         form can save much memory and time. Finally a way to get
  12.         your "too big" pictures into XiPaint...
  13.     Included JPeg support (esp. useful e.g. for downscaled loading)
  14.     Automatic installation script added.
  15. new in V3.0: TrueColor animation saving support in HHsYUVSq animation format
  16.     ->create your own TrueColor animations for playback on CyberGraphX
  17.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  18.     Including ARexx script for automatic conversion of picture
  19.       directories into HHsYUVSq animation format
  20.  
  21. This universal module can be used to load images in many file formats
  22. (more than 20 and additionally Datatypes) very fast into XiPaint (including
  23. optional downscaling) and to create TrueColor animations in HHsYUVSq
  24. animation format.
  25.  
  26. Warning: I am aware that illegal/modified keyfiles of this module may exist.
  27. !Use of such keyfiles ("hhsxipaintmodkey.library") is strictly prohibited and
  28. !can lead to undefined results and problems! For a program which you use
  29. !you should also be willing to pay the shareware fee. Only if enough users
  30. !register I will be able to do further improvements or create other graphic
  31. !applications. You can also help me by sending me illegal keyfiles of
  32. !this product which you find somewhere.
  33.  
  34. Installation
  35. ------------
  36.  
  37. The module can be installed automatically with the included script: Simply
  38. start it and select the XiPaint main directory in the file requester. The
  39. needed files will then be installed.
  40.  
  41. If you prefer manual installation: "hhsxipaintmod.xio" is the main module
  42. and should be copied to the XiPaint/Modules directory for XiPaint 3.2 and up.
  43. For older versions the module should be copied to the XiPaint main directory
  44. and the additional ARexx script "hhsxipaintloader.rx" should come into
  45. the XiPaint/Makro directory. For all versions the "makeanim.rx" script can
  46. be installed in the XiPaint/Makro or XiPaint main directory.
  47.  
  48. Usage
  49. -----
  50.  
  51. 1) XiPaint 3.2 or higher (incl. XiPaint 4.x): The module will be detected
  52.    by XiPaint
  53.  
  54.   a) as "HHsUniversalLoader", "Universal_50%_size" and "Universal_25%_size"
  55.      which you can then select in the Settings/Loaders list of loader
  56.      modules. The Loader will be automatically used (if selected) for
  57.      opening of new projects and for loading into existing projects.
  58.      To load pictures in half or quarter size, use the %_size loaders.
  59.  
  60.   b) as "HHsYUVSqAnimation" which you can then select in the Settings/Savers
  61.      list of saver modules. To create a new animation, select a new filename
  62.      for saving with this format; to append a frame to an existing animation,
  63.      select the existing animation file for saving. XiPaint will warn you
  64.      that the file is overwritten, but the module will only append the frame
  65.      and not delete the old file.
  66.  
  67.      Please note: Image width must be in the range 80 to 360 (even size will
  68.      be generated); Image height must be in the range 64 to 310. To append
  69.      frames to an animation, the image size in XiPaint must match the frame
  70.      size of the file you want to append to. Otherwise (or if you specify
  71.      not a HHsYUVSq anim file) an error will occur.
  72.  
  73.    To automatically create an animation from a directory of pictures you
  74.    can use the included ARexx script "makeanim.rx". This will do automatic
  75.    downscaling. Please see notes below.
  76.  
  77.    The module has been tested with XiPaint 3.2 and the new XiPaint 4.0!
  78.  
  79. -> XiPaint-CD: If you have problems with XiPaint on CD-ROM,
  80.    you should check your file system; some CD file systems
  81.    only support upper case file names; XiPrefs looks only for
  82.    lower case xout-libraries; use another file system or rename
  83.    the libraries to lowercase manually (on your harddisk) like
  84.    rename XiPaint/libs/XOUT_C.LIBRARY "XiPaint/libs/xout_c.library"
  85.    etc... This should solve your problems.
  86.  
  87. 2) XiPaint 3.0/3.1
  88.  
  89.   As thoose XiPaint versions have no direct support for external modules,
  90.   you can only access it by the included ARexx scripts.
  91.  
  92.   a) For loading: Execute the "hhsxipaintloader.rx" macro (with the
  93.      menu function Macro/Execute).
  94.      It will then switch to the WB screen and display a standard
  95.      file requester. You can then select a file for loading. The
  96.      picture will be loaded if possible and transferred to XiPaint
  97.      as a new project window. Then the WB screen is sent back so
  98.      that XiPaint screen should appear in front again. Some XiPaint
  99.      versions add absolute path names of new project windows to the
  100.      relative standard path. I can't work around this, so such
  101.      pictures will get wrong project names with such versions (Only
  102.      use SaveAs to save such pictures). Please upgrade to XiPaint 3.2
  103.      to get a more convenient access to my module...
  104.  
  105.   b) For TrueColor animation creation: Execute the automatic script
  106.      "makeanim.rx"; see below for details.
  107.  
  108. Supported file formats
  109. ----------------------
  110.  
  111. Supported file formats for loading:
  112.  
  113. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  114. * JPeg (color and greyscale; see notes below)
  115. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  116. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  117. * QRT (also known as dump format by PD raytracers as POV-Ray)
  118. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  119. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  120. * MacPaint (b&w compressed 1Bit format; datafork only)
  121. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  122. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  123. * EGS7.x window iconification file format
  124. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  125. * RGB formats (RGB8, RGBN, RGB5)
  126. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  127. * FBM formats (8Bit grey/color and 24Bit)
  128. * IFF-PBM (DPII) format
  129. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  130. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  131. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  132. * HHsYUVSq sequence format (sequential or random access; only first frame)
  133. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  134. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  135. * TBCPlus frames&fields
  136.  
  137. * DataType (incl. first frame of animations with Anim-Datatypes)
  138.  
  139. Supported file formats for saving:
  140.  
  141. * HHsYUVSq animation format
  142.  
  143. Automatic creation of HHsYUVSq TrueColor animations
  144. ---------------------------------------------------
  145.  
  146. With the script "makeanim.rx" you can automatically convert a directory
  147. of pictures into an HHsYUVSq animation file. Just start the script
  148. from XiPaint as macro or from Workbench or Shell. It should work with
  149. all XiPaint 3.x and up versions. If you start it from XiPaint, you will
  150. probably have to switch to WB screen manually; there you get a requester
  151. asking for the source directory which should contain the pictures
  152. (all of the same size). Then you are asked for the destination animation
  153. file. Then the automatic conversion is started. Pictures are downscaled
  154. if necessary. You can watch the pictures beeing loaded in XiPaint. They
  155. are loaded in alphabetical order (users of old XiPaint versions prior to
  156. V3.2 should NOT play with XiPaint during this process as this can
  157. block the whole system). With newer versions it should be save to
  158. use XiPaint for other things during the process except loading as
  159. this would interact with the frame loading! If the conversion has finished,
  160. the last picture will remain in XiPaint as a project. You can close
  161. this manually.
  162.  
  163. To play the animations use my freeware player programs
  164. CyberTVPlayer for TrueColor playback on CyberGraphX compatible
  165. boards (incl. Draco) or EGSTVPlayer for TrueColor playback on
  166. EGS compatible boards. CyberTVPlayer can also be used without
  167. CyberGraphX for reduced viewing (upto 256 colors) on all Amigas
  168. with at least OS3.0.
  169.  
  170. Additional notes: The loading/saving is done with HHsXiPaintMod.xio
  171. only; so you can only load pictures in one of the supported formats
  172. (see above). If you want to make animations from pictures in other formats,
  173. you have to load and save them with the appropriate modules manually.
  174. But anyway, the module now seems to support nearly all formats...
  175.  
  176. Downscaled loading
  177. ------------------
  178.  
  179. The loader module now supports direct downscaled loading in XiPaint 3.2
  180. and higher; simply select the appropriate loader version in the list.
  181. Currently the loader should appear 3 times: HHsUniversalLoader for full
  182. size, Universal_50%_Size for half size and Universal_25%_Size for quarter
  183. size. For most file formats (e.g. IFF, DEEP, JPeg, PCX, PPM, Targa, ...)
  184. the downscaling is done on a line by line base, so that memory will only
  185. be needed for the reduced size. This should enable you to get big
  186. pictures into XiPaint without memory problems.
  187.  
  188. General notes
  189. -------------
  190.  
  191. There are currently no error requesters for loading (if a file can not be
  192. loaded nothing will happen). For saving error requesters are included.
  193.  
  194. If you register for the XiPaint modules you will receive a
  195. keyfile together with the latest version of the modules. The
  196. keyfile will enable you to use future demo versions as update.
  197.  
  198. The demo version will load and save all pictures in greyscales, but
  199. usually at the same speed as the full version would do in color.
  200.  
  201. XiPaintModules need at least OS2.04 (OS3.x for Datatype usage).
  202.  
  203. All loading functions (except JPeg: This software is based in part on the work
  204. of the independent JPeg Group) have been written in Assembler and optimised for
  205. extremely high speed. An exception to this is the JPeg format, which is
  206. written in C and based on the usual code of the indipendent JPeg group.
  207. I created the fast loading functions mainly for my famous shareware programs
  208. *** CyberShow Professional *** (universal viewer and slideshow program
  209. for all OS3.x Amigas and Dracos and esp. for CyberGraphX users), EGSPhotoAlbum
  210. Prof. and EGS-TV Prof.; When new formats are implemented for my other
  211. programs (or the speed is improved further), I will usually also update
  212. the modules, which registered user can then use due to the keyfile concept.
  213.  
  214. The JPeg format has been included in this module mainly for the comfort
  215. of the users (as otherwise for JPeg another loader module would have to
  216. be seleted) and to enable JPeg loading in downscaled form, which can be
  217. very useful. Now you can also create animations in HHsYUVSq animation
  218. format from JPeg pictures with the automatic ARexx script. The loading
  219. speed of the JPeg code (for pictures in full size) is unfortunately
  220. currently not very fast. Downscaled loading of JPeg can be much faster.
  221.  
  222. Registration
  223. ------------
  224.  
  225. You can register for the module at the small add-on price of only 8US$ or
  226. 10DM if you order it together with one of my other shareware programs,
  227. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  228. with at least OS3.0 (loading the same formats as the XiPaintModule)
  229. or EGSPhotoAlbum or EGS-TV. Please use the registration forms of thoose
  230. programs and specify your add-on module order there and include the
  231. extra amount.
  232.  
  233. Otherwise you should use the included registration form to register:
  234.  
  235. If you only want to register for the module, the registration fee is
  236. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  237. versions of my other programs. Additional modules (e.g. UniversalGIO for
  238. Photogenics or FastIFXModules for ImageFX) can be ordered at the lower
  239. add-on price.
  240.  
  241. If you are already a registered user of one of my programs and now want to
  242. register for the modules, the registration fee is 13US$ outside europe or
  243. 15DM (in europe). Additional modules (e.g. UniversalGIO for Photogenics or
  244. FastIFXModules for ImageFX) can be ordered at the lower add-on price.
  245.  
  246. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  247.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  248.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  249.  Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
  250.  das Programm was Sie schon haben und die Registriernummer angeben.
  251.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  252.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  253.  (No bank transfers from outside germany!)
  254.  
  255. Send your filled in registration form together with cheque, international
  256. postal money order or banknotes to:
  257.  
  258.     Helmut Hoffmann
  259.     Rubensstrasse 4
  260.     D-41063 Moenchengladbach
  261.     Germany
  262.  
  263. Special Thanks
  264. --------------
  265.  
  266. My special thanks go to Mr. Thomas Dorn and Ossowski's Schatztruhe for
  267. providing me with XiPaint.
  268.  
  269. Disclaimer
  270. ----------
  271.  
  272. This software (program and documentation) is provided "as is" and
  273. comes with no warranty, either expressed or implied.
  274. The author is in no way responsible for any damage or loss that may
  275. occur due to direct or indirect usage of this software. You use
  276. this software entirely at your own risk.
  277.  
  278. Copyright and Distribution
  279. --------------------------
  280.  
  281. HHsFastUniversalXiPaintModule (module and documentation) is copyright by
  282.  
  283.     Helmut Hoffmann
  284.     Rubensstrasse 4
  285.     D-41063 Moenchengladbach
  286.     Germany
  287.  
  288. The demo version may be freely distributed and used as
  289. long as the following conditions are met:
  290.  
  291. 1) All files have to be kept together
  292.  
  293. 2) No file may be modified or crunched/packed.
  294.  
  295.    The only official way to distribute the demo packed is the
  296.    original xipaintmod.lha archive.
  297.    The modules may not be disassembled or analysed. The limitations
  298.    integrated in the demo version may under no circumstance be removed
  299.    or bypassed.
  300.  
  301. 3) Distributors may only charge for the duplication process (including media)
  302.    and not for the software. Theese charges may not exceed the following
  303.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  304.               postage&packing (in Germany: 10DM)
  305.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  306.               postage&packing (in Germany: 60DM)
  307.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  308.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  309.               for downloading
  310.    Anyway, it must be made explictly clear to the buyer, that he does not
  311.    pay for the modules (demo) itself but only for the duplication service.
  312.  
  313. 4) It is not allowed to distribute this demo with any commercial product
  314.    without a written permission by me. One exception is the distribution of
  315.    the demo version with products not exceeding the above price limits (e.g.
  316.    a cover-disk magazine for 7$ or less).
  317.  
  318.    The following companies have my explicit permission to distribute the
  319.    demo with their products: Ingenieurbüro Helfrich, MacroSystem.
  320.    The demo version may also be included with the XiPaint software.
  321.  
  322. 5) The registered version may not be redistributed. It may only run on one
  323.    machine per registration. It is allowed to make a backup copy of the
  324.    original disk.
  325.  
  326. Version history
  327. ---------------
  328.  
  329. V0.1 (7th aug. 95): Prerelease for loading functions
  330. V0.2 (20th aug. 95): Prerelease for loading by ARexx script:
  331.             added Request option and screen switching functions
  332. V1.0 (15th sep. 95): First official release for use by Arexx script (usable
  333.             with XiPaint 3.x)
  334. V2.0 (21st sep. 95): First release with direct loader module support for
  335.             XiPaint 3.2 (just copy the .xio file into the
  336.             XiPaint/Modules directory and configure it as loader)
  337. V2.1 (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  338.             and more variants
  339. V3.0 (11th dec. 95): TrueColor animation saving: extended module to support
  340.             saving in HHsYUVSq animation format;
  341.             included ARexx script to automatically create such
  342.             animations from multiple pictures
  343.              Extended IFF loader to accept 0-sized chunks
  344.              Loader can now load bigger pictures into smaller projects
  345.              Integrated downscaling support (only usable by scripts)
  346. V4.0 (9th feb. 96): Support for downscaled loading (50% size, 25% size) by
  347.             additional entries in the XiPaint 3.2 loader list
  348.             Added JPeg loading support (see special notes for JPeg!)
  349.             Included script for automatic installation of modules
  350.             Bug fixes in makeanim.rx script: now should also work
  351.             if other project windows exist during anim creation
  352.             Extended IFF loader to accept unusual sized color maps
  353. V4.1 (24th march 96): Changed PCX loading for more compatibility
  354. V4.2/3 (29th april 96): Extended PCX loading for even more compatibility
  355.  
  356.  
  357. ============================= Archive contents =============================
  358.  
  359. Original  Packed Ratio    Date     Time    Name
  360. -------- ------- ----- --------- --------  -------------
  361.      628     270 57.0% 08-Feb-96 17:12:00  XiPaintModule.info
  362.      884     372 57.9% 11-Dec-95 00:17:48 +hhsxipaintloader.rx
  363.    16529    6667 59.6% 29-Apr-96 01:36:52 +hhsxipaintmod.readme
  364.      477     250 47.5% 08-Feb-96 17:11:46 +hhsxipaintmod.readme.info
  365.    86516   41747 51.7% 28-Apr-96 21:04:22 +hhsxipaintmod.xio
  366.     1254     465 62.9% 09-Feb-96 00:47:34 +Install
  367.      466     132 71.6% 08-Feb-96 17:11:46 +Install.info
  368.     2168     872 59.7% 08-Feb-96 19:21:04 +makeanim.rx
  369.      461     177 61.6% 08-Feb-96 17:11:46 +makeanim.rx.info
  370.     2211     963 56.4% 28-Apr-96 21:26:42 +registration.txt
  371.      477     248 48.0% 08-Feb-96 17:11:46 +registration.txt.info
  372. -------- ------- ----- --------- --------
  373.   112071   52163 53.4% 01-May-96 09:35:28   11 files
  374.